@database MyClock.guide
@master Prog:Programs/MyClock/MyClock1_30/MyClock.guide
@$VER: MyClock.guide 1.31 (23.6.95)
@wordwrap
@node "Main" "MyClock v1.31"
   Welcome to @{b}@{fg shine}MyClock v1.31@{ub}@{fg text}
          By Marco Negri
   @{"Introduction" link "Introduction" 0}
   @{"Requirements" link "Requirements" 0}
   @{"Usage" link "Usage" 0}
     @{"From Workbench" link "FromWB" 0}
     @{"From the Shell" link "FromShell" 0}
   @{"ARexx Commands" link "ARexx Commands" 0}
   @{"History" link "History" 0}
   @{"The Author" link "Author" 0}
   @{"Future" link "Future" 0}
   This program is @{fg shine}CardWare@{fg text}, that is you can freely use, copy
   and distribute this program. The only thing I'm asking you
   is to send @{"me" link "Author" 0} a post card or a message by E-Mail, because
   I'd like to see where my program is used.
   Enjoy it...
@endnode
@node "Introduction" "Introduction"
   @{b}@{fg shine}Introduction@{ub}@{fg text}
   MyClock is a small program that displays a digital clock
   on the screen bar of any public screen.
   It is very useful because it allows you to see quickly
   the time anytime and it is also very smart.
   If like it, you can put it in your WBStartup drawer and
   you'll always have a beautiful clock on the Workbench.
   You can use it also on your favourite application screen.
   These are the features of MyClock:
   - Smart look. It appears in the screen bar and it seems
     a built-in clock of the system.
   - It can be opened on any public screen.
   - It supports an optional ARexx port, allowing you to
     interface MyClock with any other application (for
     example you an choose to open it on the public screen
     of your favourite text editor, and to force it to close
     automatically (via ARexx) when quitting the editor).
   - It is fully localized.
   - It inherit the colors, the font and the style of the
     screen in which it appears.
   - Proportional fonts are fully supported.
   - It is really accurate. In fact I've seen around many
     clock programs not really accurate (for example the
     system Clock or the wonderful DirectoryOpus).
     If you try to run two or three times DOpus (if you have
     enough memory) you will see that the seconds doesn't
     change at the same time. If you do the same thing with
     MyClock you will see perfect synchronization between
     the clocks.
   - It is fully 2.0, 2.1, 3.0, 3.1 compatible.
   - It is very small (only 5180 bytes).
   - It doesn't slow down the performance of your machine.
     The CPU occupancy increase is less than 1%.
   - But, above all, it's MADE BY @{"ME" link "Author" 0}.
@endnode
@node "Requirements" "Requirements"
   @{b}@{fg shine}Requirements@{ub}@{fg text}
   MyClock v1.30 works on any Amiga with OS 2.0+
   It has been actually tested on:
   A500 - 512K Ram - OS 2.04
   A500 - 3MB Ram - 80MB Hard Disk - OS 2.04
   A1200 - 2MB Ram - 80MB Hard Disk - OS 3.0
   A3000 - 8MB Ram - 120MB Hard Disk - Picasso II Board - OS 3.0
   A4000/030 - 4MB Ram - 120MB Hard Disk - OS 3.0
   If you found some bugs or have some problems on your
   configuration please contact the @{"Author" link "Author" 0}.
@endnode
@node "Usage" "Usage"
   @{b}@{fg shine}Usage@{ub}@{fg text}
   You can start the program from @{"Workbench" link "FromWB" 0} or from the @{"Shell" link "FromShell" 0},
   and after you will a digital clock on the screen bar of
   the selected screen.
   To quit the program you have to press the left mouse button
   over the clock (you will see a copyright on the screen
   bar), and after you have to press the right menu button
   to quit the program.
@endnode
@node "FromWB" "From the Workbench"
   @{b}@{fg shine}From the Workbench@{ub}@{fg text}
   From the Workbench the only thing you have to do is
   double-clicking on the icon.
   The following tooltypes are supported:
   @{"SECONDS" link "Seconds" 0}
   @{"DATE" link "Date" 0}
   @{"DAY" link "Day" 0}
   @{"12HOURS" link "12Hours" 0}
   @{"SCREEN" link "Screen" 0}
   @{"NOBACKDROP" link "NoBackdrop" 0}
   @{"REXX" link "Rexx" 0}
@endnode
@node "FromShell" "From the Shell"
   @{b}@{fg shine}From the Shell@{ub}@{fg text}
   From the Shell the you must type the name of the program
   followed by the optional arguments.
   The template of the command is:
   MyClock @{"SECONDS=SECS" link "Seconds" 0}/S,@{"DATE" link "Date" 0}/S,@{"DAY" link "Day" 0}/S,@{"12HOURS" link "12Hours" 0}/S,@{"NOBACKDROP" link "NoBackdrop" 0}/S,@{"SCREEN" link "Screen" 0}/K,@{"REXX" link "Rexx" 0}/K
@endnode
@node "Seconds" "SECONDS"
   SECONDS=SECS/S:
     If this option is specified then MyClock will show
     also the current seconds.
   DEFAULT:
     By default the seconds will not be showed.
@endnode
@node "Date" "DATE"
   DATE/S:
     If this option is specified MyClock will show
     also the current date of the year.
     The DOS format (DD-MMM-YY) will be used).
   DEFAULT:
     By default the date will not be showed.
@endnode
@node "Day" "DAY"
   DAY/S:
     If this option is specified then MyClock will show
     the current day of the week.
     The name of the day is localized, that is it depends
     on the language chosen in ENV:Sys/locale.prefs
   DEFAULT:
     By default the day of the week will not be showed.
@endnode
@node "12Hours" "12HOURS"
   12HOURS/S:
     If this option is specified then the time will be
     showed in the AM/PM format.
   DEFAULT:
     By default the time is showed in 24 hours mode.
@endnode
@node "Screen" "SCREEN"
   SCREEN/K:
     If this option is specified then MyClock opens on the
     named public screen.
     If an asterisk '*' is specified as name, then MyClock
     will open on the frontmost public screen.
     If the public screen does not exist then MyClock will
     open on the default public screen.
   DEFAULT:
     By default MyClock will open on the default public
     screen (usually the Workbench).
@endnode
@node "NoBackdrop" "NOBACKDROP"
   NOBACKDROP/S:
     This option is included only for compatibility with
     some applications which open a public screen and a
     backdrop window covering the screen title.
     As MyClock call the Intuition function:
     ShowTitle (screen, FALSE);
     the application window may hide the screen bar, giving
     an ugly display.
     This can avoided by specifying with this option.
     (First try without this option, then if you have
     some problems try specifying it).
   DEFAULT:
     By default the option is not specified.
@endnode
@node "Rexx" "REXX"
   REXX/K:
     If this option is specified then an ARexx port with
     the name specified will be opened.
     See the @{"list of ARexx Commands" link "ARexx Commands" 0}.
   DEFAULT:
     By default MyClock doesn't open any port.
@endnode
@node "ARexx Commands" "ARexx commands"
   @{b}@{fg shine}List of ARexx Commands@{ub}@{fg text}
   For the moment only one command is supported.
   @{"QUIT" link "Quit" 0}
@endnode
@node "Quit" "QUIT"
   QUIT:
     This command forces MyClock to quit.
@endnode
@node "History" "History"
  @{b}@{fg shine}History of MyClock@{ub}@{fg text}
  -- v1.23 -- 23-Feb-95 --
  * First official release
  -- v1.30 -- 19-Apr-95 --
  * ARexx port added. (Name chosen by the user)
    QUIT command supported.
  * NOBACKDROP option added for compatibility with
    some applications.
  * Improved text-length handling: minimal screen
    bar occupancy.
  * When specified an asterisk '*' as SCREEN, MyClock
    opens on the frontmost screen.
  -- v1.31 -- 23-Jun-95 --
  * 12HOURS switch added.
@endnode
@node "Author" "The Author"
   I'm a student of Economics, but in my free time I like to
   program my Amiga, the best computer around.
   My address is:
  @{fg shine} Marco Negri
   Via delle Alpi 19
   20026 Novate Milanese
   MILANO - Italia@{fg text}
   E-Mail:
   @{fg shine}s592345@vm.uni-bocconi.it@{fg text}
@endnode
@node "Future" "Future"
   The future improvement of MyClock will be the possibility
   to overrid the fonts, colors and something else of the
   screen it opens into.
   If you think something that it would be useful for MyClock
   please let the @{"me" link "Author" 0} know, I'll be happy to implement it in
   a new version and to send it to you when done.
@endnode